#####################################################################

                        PhotoV VBX Control

                 Copyright 1995 Northeast Data Corp.

                        All Rights Reserved


#####################################################################


                           Version 2.0


Product Description
===================

PhotoV is a VBX custom control that runs under Microsoft Windows
version 3.1 or later. It displays and prints JPEG, 
TIFF (Color, Group 3, Group 4), PCX, BMP, Targa, Photo CD and GIF files. 

The control can be used in Visual Basic versions 1.0 through 3.0 and
later, and in Visual C++ version 1.0 or later. It is supported by the
CVBControl Microsoft Foundation class in the C++ environments.


Legal Information
=================

Northeast Data Corp. owns the PhotoV VBX custom control. The demo version
of the control is "shareware". It displays a registration dialog box 
each time the application using the control is started. Users who register
the control with Northeast Data receive a commercial version of the control,
which is the same as the demo version but does not display the registration
dialog box. 

All users of the PhotoV VBX custom control are granted the right to use the
control in any applications they develop, without paying royalties of any
kind to Northeast Data Corp. Also, users are not required to mention
Northeast Data Corp. in any documentation or software that accompanies 
their products.

Registered users may not distribute the pcvctl.lic file with their 
applications. This file allows the VBX to run in the design-time
environment.


Recommended Equipment
=====================

486/33mhz PC 
16.7 million color ("True Color") video adapter
8mb RAM

Performance is affected significantly by your video adapter. PhotoV will
operate with lower resolution adapters (down to 256 colors), a 386 CPU,
and 4mb memory, but works best with the recommended configuration.

The best files to view are Photo CD files, since they are optimized for
PC video display. The other file formats were developed at a time when
PC video display hardware was less capable.


Installation
============

Copy these files to the WINDOWS\SYSTEM directory:

   vic.dll, 
   pcdlib.dll, 
   pcdxbmp.dll
   pcdxtif.dll
   pcdxrif.dll
   pcdxeps.dll
   pcdxpcx.dll
   vbrun300.dll
   cmdialog.vbx
   photov.vbx
   photofx.dll

All other files can reside in the original installation directory. 

-----------------------------------------------------------------------
If you have the registered version of the control, the pcvctl.lic file
must reside in the same directory as your VB project files.

The pcvctl.lic file must not be distributed to your customers! It is
only available to registered users, who are allowed to use the VBX
in the design environment.
-----------------------------------------------------------------------

If you have Visual Basic, you can run it and load the project file from
the installation directory. You can also add the photov.vbx file into a
new project.

If you do not have Visual Basic, you can run the Photov.exe file directly
from the installation directory.

If you are using Visual C++, you need access to the photov.h file. You 
should copy this file into your INCLUDE path.


Software Development Information
================================

The following describes the properties and events implemented in the
PhotoV custom control. 


Properties
----------

About

   Displays information about the PhotoV custom control


BackColor

   Color that appears around the image, inside the image window


Command

   1 - ZoomIn

   2 - ZoomOut

   3 - Increase Contrast

      Note: Contrast adjustment is not available for Photo CD images.

   4 - Decrease Contrast

      Note: Contrast adjustment is not available for Photo CD images.

   5 - Print

      Prints the image. The size of the image is about the same as it is 
      currently on the screen.

   6 - Copy

      Copies the selected image region to the clipboard. The user selects
      a region by dragging with the right mouse button.


Compression

   This property is used whenever the SaveAs property is set. It 
   determines the compression to use for the specified SaveAs file type.
   For these types, the values are:

      .BMP     0 - no compression
               1 - RLE8 compression

      .JPG     0 - 100 for image quality. 100 gives the highest quality.
                   Values less than 100 produce a smaller image file, but
                   with poorer image quality.

      .PIW     0 - no compression
               1 - compression

      .TGA     0 - no compression
               1 - RLE compression

      .TIF     For bitonal images:     
      
                  0 - none
                  1 - packbits
                  2 - Group 3
                  3 - Group 4

               For Grayscale or 8-bit images:

                  0 - none
                  1 - LZW
                  2 - packbits
                 
               For RGB (24 bit) images:

                  0 - none
                  1 - LZW


DragIcon

   A standard VB property


DragMode

   A standard VB property


Effect    - Visual effect to be applied when the next image file
            is selected:

               0  - normal display

               1  - Vertical top&bottom wipe

               2  - Horizontal left&right wipe

               3  - Top left to bottom right wipe

               4  - Top right to bottom left wipe

               5  - Bottom right to top left wipe

               6  - Bottom left to top right wipe

               7  - Inward spiral

               8  - Outward spiral

               9  - Left wipe

               10 - Right wipe

               11 - Top wipe

               12 - Bottom wipe

               13 - Vertical top & bottom wipe from center

               14 - Horizontal left & right wipe from center

               15 - Vertical venetian blind

               16 - Horizontal venetian blind


hdcPrn

   Handle to the HDC for printing. If you do not specify an HDC, the
   PhotoV control will create one. Specifying an HDC allows the PhotoV
   control to use the same printer that you may have specified for other
   print functions in your application (where the user may have selected
   a different printer from the default one).


Height

   Height of the PhotoV window, in twips.


HScrollPos

   Horizontal scroll position of the image, in pixels.


ImageHeight

   The height of the loaded image in pixels.


ImageWidth

   The width of the loaded image in pixels.


Index

   A standard VB property.


Left

   Left side of the PhotoV window, in twips.


Menus

   A string that has a "0" or "1" character for each of these functions:


      Operation            Position in string
      -------------------- ------------------
      MENUCOPY              1
      MENUBESTFIT           2
      MENUFITVERT           3
      MENUFITHORZ           4
      MENU1TO1              5
      MENUINCREASECONTRAST  6
      MENUDECREASECONTRAST  7
      MENUZOOMIN            8
      MENUZOOMOUT           9
      MENUPRINT             10
      MENUROTATE0           11
      MENUROTATE90          12
      MENUROTATE180         13
      MENUROTATE270         14


   This is the same string that is sent in the "MenuChange" event
   parameter described below.
   
  
Name

   A standard VB property.

Picture

   The full filename of the image file to display. 


Rotation

   0 - 0 degrees
   1 - 90 degrees
   2 - 180 degrees
   3 - 270 degrees


RightsFile

   Full filename of rights file on Photo CD. This property is read-only
   and is not used for non-Photo CD images.
   

SaveAs

   Full filename of file to save the current image to. The file extension
   determines the file format. These are the valid formats:

      For Photo CD images:

         .BMP     - Windows bitmap
         .EPS     - Encapsulated Postscript
         .PCX     - PCX (Windows Paint)
         .RIF     - Resource Interchange 
         .TIF     - TIFF (uncompressed)

      For other image types:
         .BIF     - Binary Information File
         .BMP     - Windows bitmap
         .EPS     - Encapsulated Postscript
         .JPG     - JPEG
         .PCX     - PCX (Windows Paint)
         .PIW     - ZIP format
         .TGA     - Targa
         .TIF     - TIFF 

   See the description of the Compression property for compression options
   on the above formats.



ScaleMode

   0 - Fit Vertical
   1 - Fit Horizontal 
   2 - Full Size (1 to 1 scaling)
   3 - Best Fit
   4 - Scale Percent (use the value in the ScalePercent property)


ScalePercent

   The percent of original image size to display the image.


ScrollBars

   0 - None
   1 - Vertical
   2 - Horizontal
   3 - Both


ShowRightsFile

   0 - False
   1 - True

   If set to True, a messagebox is displayed before a Photo CD image
   is displayed. The messagebox shows the filename of the rights file.
   If no rights file exists, the messagebox does not appear.


TabIndex

   A standard VB property.


TabStop

   A standard VB property.


Tag

   A standard VB property.


Top

   Top of the PhotoV window, in twips.


Visible

   A standard VB property.

VScrollPos

   Vertical scroll bar settting for the image.


Width

   Width of the PhotoV window, in twips.


Events
------

MenuChange (Menu As String)

   This event is sent whenever your application menus need to be updated.
   The Menu string is described in the "Menus" property above. You can
   use this event to enable or disable the appropriate menus in your
   application.

   

Version Information
===================


V1.1  (January 1995) - First release.

V1.5  (January 1995) - Added Effect property.

V2.0  (January 1995) - Added saving of images in various file formats.
                       Added ShowRightsFile property.
                       Added RightsFile property.
               
Technical support is available only for registered users.

For technical support, call 716-247-5934 from 8:00 a.m to 5:00 p.m
Monday through Friday. You may also send a FAX to this same number.

   Northeast Data Corp.
   2117 Buffalo Rd., Suite 290
   Rochester, NY  14624

   Phone (716) 247-5934 (voice & fax)
   E-Mail 
	Internet:	ned1@frontiernet.net 
	CompuServe:	71321,3304
	
   	Home Page:	http://www.frontiernet.net/~ned1/index.htm
